/*
XPTracker - Alternative Agile Tracking Tool
Copyright (C) 2006-2009  Stephen Starkey

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
*/
package org.xptracker.persistence;

import java.util.List;
import java.util.Map;
import java.util.Set;

public interface PersistenceManager {
  String getDbType();
  void initialize(DomainRegistry domainRegistry);
  void shutdown();
  void doMaintenance();

  <T> T inTransaction(UpdateHandler<T> handler);

  <T> List<T> query(String query);

  <T> List<T> query(String query, Map<String, Object> args);

  <T> List<T> queryWithScript(String scriptName, Object... args);

  void flush();

  <T extends Identified> List<T> listObjects(Class<T> objectClass, Set<String> ids);

  <T> T loadObject(Class<? extends T> entityType, String id);

  <T> T loadObject(Class<? extends T> entityType, String id, FetchHelper<T> helper);

  interface UpdateHandler<T> {
    T doUpdate(UpdateReceiver receiver);
  }

  interface UpdateReceiver {
    void insert(Object o);
    void update(Object o);
    void remove(Object o);
  }

  static interface FetchHelper<T> {
    void fetch(T item);
  }
}
